home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILHIVE / NOAH_21Z.LZH / ARK.DOC next >
Text File  |  1989-02-15  |  41KB  |  746 lines
  1. ->         ADVANCED OR EXPERIENCED NOAH USERS SHOULD READ ARK2.DOC         <-
  2.  
  3.                               FILE = ARK.DOC
  4.  
  5.     Noah's Arkive Management System, (c) 1989 Eagle Shareware Associates
  6.              Written etc. by Sam Horton and compiled on 2/15/89
  7.                             All Rights Reserved
  8.  
  9.  
  10.                  EAGLE SHAREWARE ASSOCIATES PROUDLY PRESENTS
  11.  
  12.              ╔══════════════════════════════════════════════════╗
  13.              ║                                                  ║
  14.              ║    ██ ▌   ▌                       ┐              ║
  15.              ║    ██ ▌   ▌                       │              ║
  16.              ║    ██ ▌▌  ▌ ████▌  ██████▌ ██    ▌  ██▀▀▀▀▀      ║
  17.              ║    ██  ▌▌ ▌ ██  ▌  ██    ▌ ██    ▌  ██▌▌▌▌█      ║
  18.              ║    ██   ▌ ▌ ██  ▌  ██▌▌▌▌▌ ██▌▌▌▌▌        █      ║
  19.              ║    ██   ▌ ▌ ████▌  ██    ▌ ██    ▌  ███████      ║
  20.              ║                                                  ║
  21.              ║                                                  ║
  22.              ║             ███████▌                             ║
  23.              ║             ██     ▌                             ║
  24.              ║             ██     ▌  ██████   ██ ▌▌▌            ║         
  25.              ║             ██▌▌▌▌▌▌  ██   ▐   ██▌               ║         
  26.              ║             ██     ▌  ██▌▌▌    ██ ▌              ║            
  27.              ║             ██     ▌  ██  ▌▌▌  ██  ▌▌            ║            
  28.              ║                                                  ║         
  29.              ║                                                  ║          
  30.              ╚══════════════════════════════════════════════════╝
  31.  
  32.              QB RELEASE 2.1Z  (c) 1988 EAGLE SHAREWARE ASSOCIATES
  33.    P.O. BOX 159, GILBERTSVILLE, PA 19525-0159  (215)-367-4053 1200/2400 8N1
  34.  
  35.                        (Formerly L&C, PKSHELL 1.xx)
  36. ____________________________________________________________________________
  37. ____________________________________________________________________________
  38.  
  39.  
  40. - COMMAND SYNTAX
  41. =================
  42.  
  43. a)     ARK [EXT]
  44.  
  45. Where EXT = file extension NOAH will use for a highlight key in place of the
  46. default extension .ZIP
  47.  
  48.  
  49.  
  50. - WHAT NOAH CAN AND CANNOT DO
  51. ==============================
  52.  
  53. NOAH'S ARK is designed to allow maximum directory control when using PKZIP.
  54. NOAH can tag multiple files and pass standard PKZIP commands through a .BAT
  55. file named NOATMP.BAT, or it can pass any command line you specify.  (It does
  56. not delete this batch file on exit, so you can create it for someone else and
  57. leave it behind under another name using the DOS REN command.)
  58.  
  59.  
  60.  
  61. ARK.DOC                                                             PAGE 2
  62.  
  63. This utility is not designed to replace your file/HD manager, but does
  64. provide rudimentary (but effective) support for key DOS functions such as
  65. copying, deleting, changing drives & directories, and shelling to DOS.
  66. Support for up to 220 file entries is provided in this release, and NOTHING
  67. is disabled, crippled, or otherwise tampered with to annoy users.  You will
  68. also find NOAH very forgiving in it's handling of your tasks.
  69.  
  70.  
  71. - HOW NOAH DOES IT
  72. ====================
  73. NOAH writes to a batch file NOATMP.BAT enclosing all of the tasks you specify
  74. within the menus.  This .BAT file is then executed as a child-process (a DOS
  75. shell from within NOAH), and NOAH restarts to pick up any directory changes.
  76. NOAH always needs to operate on unprotected disks.  A write protect tab will
  77. generate the DOS error message: Abort, Retry, or Fail?
  78.  
  79.  
  80. - FEATURES WITHIN NOAH (SUMMARY)
  81. =================================
  82.  
  83.  * Mark/Unmark independent, clear, or mark all at a key w/levels of marks
  84.  * Supports common PKZIP and/or PKPAK commands at a keystroke
  85.  * Status windows & line w/files marked/total bytes marked/total in abs/%
  86.  * FULL CUSTOM COMMAND LINE OPTION (both before and after marked filespecs)
  87.    >>>> NOAH CAN DO ANYTHING YOU WISH ACROSS MULTIPLE FILESPECS <<<<
  88.    Essentially delivering a very wide range of uses.
  89.  * Key DOS functions: CD\, COPY, DELETE, DRIVE, SHELL TO DOS
  90.  
  91.  * Requirements = DOS 3.xx, 256K RAM w/color monitor, HD advised
  92.    -- A monochrome version will be available on the support BBS
  93.  * Fully enabled quality shareware *NEW* 12/21/88
  94.  * Enhancement additions to follow also FREE to registered users
  95.  
  96.   ----------------------    THE MAIN MENU SCREENS     --------------------
  97.  
  98. This is the first thing you will see after the initial I.D. screen with some
  99. graphic exceptions.  The highlight bar will appear on the first file in the
  100. subdirectory in reverse video, and you may use all of the normal movement
  101. keys to probe the directory.  (See below for a full description of all
  102. functions available.)  Keypad keys and their assigned functions are:
  103.  
  104. 1)  Home  - top of the directory
  105. 2)  End   - bottom of the directory
  106. 3)  PgUp  - one page up (or Home) with pointer at the top file of that page
  107. 4)  PgDn  - one page down (or End) with pointer at the top file of that page
  108. 5)  Up/Dn - up or down one filespec
  109. 6)  Left Arrow  - Initiate SEARCH for next .EXT (see custom highlight/color)
  110.                   file UPWARD in the directory.
  111. 7)  Right Arrow - SEARCH for next .EXT file DOWNWARD.
  112. 8)  Ins - Copy Marked
  113. 9)  Del - Delete Marked (confirms)
  114. 10) <enter> - Marks present files  (also Alt+M, <space> and "+")
  115. 11) Other F Keys and hotkeys as defined below . . .
  116.  
  117. The primary screen is set to the HELP mode with the procedural box in the
  118. lower right and the HELP bar below.  When F10 is pressed, the display goes
  119. into the ADVANCED mode showing a new informative lower left STATUS box and
  120. directory status line.  (NEXT)
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. ARK.DOC                                                               PAGE 3
  128.  
  129. ╔═════════════════════════════════════════════╦═══════[ Function Keys ]════════╗
  130. ║  ANSI.SYS           1709   9-16-87  12:00p  ║F1 - Standard Add Files to .ZIP ║
  131. ║  ARK1.EXE          96039  12-01-88  10:59p  ║F2 - Standard Archive Extract   ║
  132. ║  ARKDOC.ARC        13222  11-29-88   1:00p  ║F3 - Mark All Files Displayed   ║
  133. ║  ARKREG.TXT         1598  11-28-88   9:36p  ║F4 - Clear & Toggle Marks       ║
  134. ║  AUTOEXEC.BAT        277  12-01-88   1:47p  ║F5 - Unmark All Files Displayed ║
  135. ║  BACKUP.M_U        67072  12-09-88   5:13p  ║F6 - Version Toggle: PKZIP      ║
  136. ║  BBSREG.TXT         2019  11-28-88   9:55p  ║F7 - Full Custom Command Line   ║
  137. ║  BRUN40.EXE        76816  10-08-87   5:57p  ║F8 - Customize Highlight/Colors ║
  138. ║  CACHE.EXE         14000   9-17-87  12:00p  ║F9 - Change Drive/Directory     ║
  139. ║  CBOOT.BAT           176  11-08-88   1:40a  ║F0 - Advanced Display           ║
  140. ║  CLEAN.BAT            39  11-07-88   3:29a  ╟─────────[ Help Window ]────────╢
  141. ║  COMMAND.COM       25332   9-16-87  12:00p  ║ 1) Mark the files you want to  ║
  142. ║  XONFIG.EXE        88945   1-01-89   3:07a  ║    work with.                  ║
  143. ║  CONFIG.SYS          108  11-08-88   9:40a  ║ 2) Select an option from above,║
  144. ║  DELETE.BAT           15  11-07-88   3:22a  ║    or press your slash key  /  ║
  145. ║  EZ.BAT               48  12-02-88  11:29a  ║    and select from the list.   ║
  146. ║  EZBATMAN.EXE       5629  12-01-88   8:36p  ║ 3) NOAH will prompt you for    ║
  147. ║  EZINSTL.BAT         102  11-28-88   9:33p  ║    any information required.   ║
  148. ║  EZMENU.ARC       118250  12-02-88   1:20p  ║ 4) Select Secondary Menu       ║
  149. ║  EZMENU.BAK         5081  11-29-88   3:47p  ║    option(s).                  ║
  150. ║  EZMENU.CNF           81  12-02-88  11:03p  ║ 5) Create & Execute batch file.║
  151. ║  EZMENU.DAT         1231  12-02-88   4:45a  ║                                ║
  152. ╚═════════════════════════════════════════════╩════════════════════════════════╝
  153. ▐░▌  <ESC> TO EXIT   Up/Dn PgUp/PgDn   <┘ & <SPACE> MARK FILE(S)   ? = HELP  ▐░▌
  154.  
  155. *  <ESC> confirms the request to exit, press Alt+Q to "quick exit" and drop
  156.    without the confirmation screen.  Home/End also function.  All keys are
  157.    supported both on and off the extended pad.
  158.  
  159. ** Note that Alt-M and the plus (+) key will also mark files in addition to
  160.    the <enter> and <space> keys.  The directory is always sorted in alpha
  161.    descending order by filename.
  162.  
  163. THE ADVANCED DISPLAY                                       [F10 - F12 TOGGLE]
  164. F10 toggles the display only, whereas F11 & F12 (no sub on non-extended
  165. keyboards) will toggle to NEW color schemes and the advanced display.
  166.  
  167. ╔═════════════════════════════════════════════╦═══════[ Function Keys ]════════╗
  168. ║  ANSI.SYS           1709   9-16-87  12:00p  ║F1 - Standard Add Files to .ZIP ║
  169. ║  ARK1.EXE          96039  12-01-88  10:59p  ║F2 - Standard Archive Extract   ║
  170. ║  ARKDOC.ARC        13222  11-29-88   1:00p  ║F3 - Mark All Files Displayed   ║
  171. ║  ARKREG.TXT         1598  11-28-88   9:36p  ║F4 - Clear & Toggle Marks       ║
  172. ║  AUTOEXEC.BAT        277  12-01-88   1:47p  ║F5 - Unmark All Files Displayed ║
  173. ║  BACKUP.M_U        67072  12-09-88   5:13p  ║F6 - Version Toggle: PKZIP      ║
  174. ║  BBSREG.TXT         2019  11-28-88   9:55p  ║F7 - Full Custom Command Line   ║
  175. ║  BRUN40.EXE        76816  10-08-87   5:57p  ║F8 - Customize Highlight/Colors ║
  176. ║  CACHE.EXE         14000   9-17-87  12:00p  ║F9 - Change Drive/Directory     ║
  177. ║  CBOOT.BAT           176  11-08-88   9:40a  ║F0 - Display HELP Window        ║
  178. ║  CLEAN.BAT            39  11-07-88   3:29p  ╟───────────[ STATUS ]───────────╢
  179. ║  COMMAND.COM       25332   9-16-87  12:00p  ║               0 Bytes Marked   ║
  180. ║  CONFIG.ARC          945  11-01-88   2:07p  ║       1,004,742 Total in DIR   ║
  181. ║  CONFIG.SYS          108  11-08-88   9:40a  ║    0.0% of Total are Marked    ║
  182. ║  DELETE.BAT           15  11-07-88   3:22p  ║ Estimated Compressed Sizes at: ║
  183. ║  EZ.BAT               48  12-02-88  11:29a  ║ 25% -               0 Bytes    ║
  184. ║  EZBATMAN.EXE       5629  12-01-88   8:36p  ║ 50% -               0 Bytes    ║
  185. ║  EZINSTL.BAT         102  11-28-88   9:33p  ║ 75% -               0 Bytes    ║
  186. ║  EZMENU.ARC       118250  12-02-88   1:20p  ║ Utility: PKPAK / PKUNPAK       ║
  187. ║  EZMENU.BAK         5081  11-29-88   3:47p  ║ Compatibility: NEW             ║
  188. ║  EZMENU.CNF           81  12-02-88  11:03a  ╟────────────────────────────────╢
  189. ║  EZMENU.DAT         1231  12-02-88   4:45p  ║   NOAH'S ARKIVE MANAGER 2.1Z   ║
  190. ╚═════════════════════════════════════════════╩════════════════════════════════╝
  191. ▐░▌DIR C:\BIN\UTILS              3  of  35  Marked with    2.24 MB FREE      ▐░▌
  192.  
  193. ARK.DOC                                                                PAGE 4
  194.  
  195. By watching carefully how many bytes are marked and what you expect the
  196. compression ratio to be, you can cover an entire directory for transfer or
  197. backup reasonably well.  As a guide, my experience has been the following:
  198. - Overall compression averages 40% for a given .ZIP file created.
  199. - Binary files range from as low as 5% to 40%, depending upon how much
  200.   text they contain.  I count on about 25% to be sure (you can always add
  201.   more later.... taking away is not as easy)
  202. - Pure flat ASCII text files as stored when small, and compressed up to 80-90%
  203.   in some cases.  I do not figure less than about 60%.
  204. - Upshot: figure on about the 25% line on average (to be safe) and 50% when
  205.   you get pretty optimistic.  75% for pure text files only.
  206. * Since the marks toggle when you take an action, you will no longer need to
  207.   wonder whether or not you picked up all of the files you wanted to.
  208.  
  209. FULL MAIN MENU DISPLAY                                       [ "/" to TOGGLE ]
  210.  
  211. A new highlight bar appears in the left window, and the highlight keys are
  212. enabled for that menu alone.
  213.  
  214. ╔═════════════════════════════════════════════╦═[ FULL MAIN MENU  NOAH v2.1Z ]═╗
  215. ║  ANSI.SYS           1709   9-16-87  12:00p  ║ ADD MARKED TO AN ARCHIVE    F1 ║
  216. ║  ARK1.EXE          96039  12-01-88  10:59p  ║ MOVE MARKED FILES TO .ZIP      ║
  217. ║  ARKDOC.ARC        13222  11-29-88   1:00p  ║ STANDARD ARCHIVE EXTRACT    F2 ║
  218. ║  ARKREG.TXT         1598  11-28-88   9:36p  ║ VERBOSE LISTING OF MARKED      ║
  219. ║  AUTOEXEC.BAT        277  12-01-88   1:47p  ║ VERBOSE LISTING OF ALL .ZIP    ║
  220. ║  BACKUP.M_U        67072  12-09-88   5:13p  ║ MARK ALL FILES IN DIR       F3 ║
  221. ║  BBSREG.TXT         2019  11-28-88   9:55p  ║ CLEAR & TOGGLE MARKS        F4 ║
  222. ║  BRUN40.EXE        76816  10-08-87   5:57p  ║ CLEAR ALL MARKS IN DIR      F5 ║
  223. ║  CACHE.EXE         14000   9-17-87  12:00p  ║ VIEW LIST OF MARKED FILES    L ║
  224. ║  CBOOT.BAT           176  11-08-88   9:40a  ║ UTILITY TOGGLE: PKZIP       F6 ║
  225. ║  CLEAN.BAT            39  11-07-88   3:29p  ║ FULL CUSTOM COMMAND LINE    F7 ║
  226. ║  COMMAND.COM       25332   9-16-87  12:00p  ║ READ ASCII TEXT FILE(S)        ║
  227. ║  CONFIG.ARC          945  11-01-88   2:07p  ║ VIEW EXTANT NOATMP.BAT         ║
  228. ║  CONFIG.SYS          108  11-08-88   9:40a  ║ EXECUTE CURRENT NOATMP.BAT     ║
  229. ║  DELETE.BAT           15  11-07-88   3:22p  ║ CUSTOMIZE HIGHLIGHT/COLORS  F8 ║
  230. ║  EZ.BAT               48  12-02-88  11:29a  ║ CHANGE DRIVE/DIRECTORY      F9 ║
  231. ║  EZBATMAN.EXE       5629  12-01-88   8:36p  ║ COPY MARKED                INS ║
  232. ║  EZINSTL.BAT         102  11-28-88   9:33p  ║ DELETE MARKED              DEL ║
  233. ║  EZMENU.ARC       118250  12-02-88   1:20p  ║ SHELL TO DOS                   ║
  234. ║  EZMENU.BAK         5081  11-29-88   3:47p  ║ SET HELP LEVEL FOR WINDOW  F10 ║
  235. ║  EZMENU.CNF           81  12-02-88  11:03a  ║ RETURN TO MAIN MENU          / ║
  236. ║  EZMENU.DAT         1231  12-02-88   4:45p  ║ QUIT NOAH'S ARK                ║
  237. ╚═════════════════════════════════════════════╩════════════════════════════════╝
  238. ▐░▌      <ESC> OR / TO EXIT     Up/Dn  POINT     <┘ TO SELECT MENU OPTION    ▐░▌
  239.  
  240. The main screen and Fkeys are disabled at this point and you may select any
  241. option by a "point and shoot" method.  Use Up/Dn Home/End to locate, and
  242. <enter> to select.  Below is a description of exactly what each option
  243. does.
  244.  
  245.  
  246. WHAT THE FUNCTIONS WILL ACTUALLY DO
  247.  
  248.    Selection                   Description                        Key (if any)
  249. ------------------------------------------------------------------------------
  250.  
  251. ADD MARKED TO AN ARCHIVE       PKZIP -a  SPECIFIED.ZIP  filespecs.ext      F1
  252.     - Standard ADD command.  The archive target need not have the extension
  253.       .ZIP, and is called for by NOAH in a secondary request screen.  The
  254.       default is either 1) NAME_ME.ZIP if you have not yet used the ADD/MOVE
  255.       functions, or the LAST archive filespec you gave NOAH.  (See below)
  256.  
  257.  
  258.  
  259. ARK.DOC                                                               PAGE 5
  260.  
  261. MOVE MARKED FILES TO .ZIP      PKZIP -m  SPECIFIED.ZIP  filespecs.ext      NA
  262.      - Standard MOVE command.  NOAH prompts for the target archive filename
  263.        just as it does for the ADD command above.
  264.  
  265.  
  266. STANDARD ARCHIVE EXTRACT       PKUNZIP  filespecs.ext                      F2
  267.      - Self-descriptive.  Use the CUSTOM feature to add other arguments.
  268.  
  269.  
  270. VERBOSE LISTING OF MARKED      PKUNZIP -vc filespecs.ext                   NA
  271.      - Ignores extension of marked files.  Displays archive contents on
  272.        screen.
  273.  
  274.  
  275. VERBOSE LISTING OF ALL .ZIP    PKUNZIP -vc *.ZIP                           NA
  276.      - Displays composite list of the contents of all .ZIP files in the
  277.        default directory on screen.  Writes to temporary file called
  278.        ALLARC.TXT.  Deletes temp file assuming no serious error occurs.
  279.        (A forthcoming ESA utility called ARKKIT will become available for
  280.        this type of task shortly.)
  281.  
  282.  
  283. MARK ALL FILES IN DIR          Marks all files                             F3
  284.      - Marks all files in the current directory regardless of their
  285.        current status.
  286.  
  287.  
  288. CLEAR & TOGGLE MARKS           Clears marked, toggles.                     F4
  289.       - Clears the marked list, toggles all marks from arrows (marked) to
  290.         diamonds (1st level) to boxes (2nd level).  e.g. if you had 5 files
  291.         marked and pressed this key, there would be zero marked but their
  292.         symbols would toggle to diamonds.  Pressed again, F4 would make those
  293.         diamonds squares.  This is most useful for tracking which files were
  294.         just marked, which were marked before those, and whether or not
  295.         you have covered all files in a given subdirectory.  Note that the
  296.         last set of marked is toggled to diamonds even when you change
  297.         directories (assuming there were duplicates) and/or whenever NOAH
  298.         picks up a new directory listing.  The diamonds and squares will
  299.         disappear when NOAH reads a new directory.
  300.  
  301.  
  302. CLEAR ALL MARKS IN DIR         Clears ALL marks.                           F5
  303.       - Clears all marks, regardless of their status.
  304.  
  305.  
  306. VIEW LIST OF MARKED FILES      On screen list of marked filenames.          L
  307.      - Displays a list of all currently marked files.  (Arrows only)
  308.  
  309.  
  310. UTILITY TOGGLE: PKZIP          Toggles to PKZIP/PKUNZIP.                    F6
  311.      - Determines what NOAH uses as the default utility at the command
  312.        line.  e.g. in F1 above the command line would change to PKZIP -a
  313.  
  314.  
  315. FULL CUSTOM COMMAND LINE    See full description below.                    F7
  316.      - Allows you to utilize your expertise in specifying anything for
  317.        NOAH to pass to DOS both before and after the marked list of
  318.        filenames.  By using this feature, NOAH can do anything you want
  319.        to any list of files you select.
  320.  
  321.  
  322.  
  323.  
  324.  
  325. ARK.DOC                                                              PAGE 6
  326.  
  327. READ ASCII TEXT FILE(S)        Rudimentary top-down list of a file.        F8
  328.      - Treats the marked set as pure ASCII text files and attempts to
  329.        scroll them to the screen.  NOAH will -NOT- be able to filter all
  330.        low/high ASCII codes and so some unpredictable results may
  331.        arise from the use of this feature.  e.g. ASCII 13 will make NOAH
  332.        display a line feed (cr) and other codes will cause NOAH to clear
  333.        the screen etc.  This function provides a "quick and dirty" look
  334.        at an ASCII file or set of ASCII files.  In fact, attempting to
  335.        view some binary files will cause NOAH to halt with an error
  336.        condition.  For most files it works without a hitch, so don't be
  337.        afraid to try it out.  NOAH truncates all lines at 80 characters for
  338.        display.  NOAH never writes to those files.
  339.  
  340.  
  341. VIEW EXTANT NOATMP.BAT         On screen list of NOATMP.BAT                NA
  342.      - Displays the batch file NOAH creates to execute the tasks you
  343.        specify.  (See above under WHAT NOAH DOES)
  344.  
  345.  
  346. EXECUTE CURRENT NOATMP.BAT     Invokes NOATMP as a child-process           NA
  347.      - Will invoke the NOATMP.BAT file in the current subdirectory OR
  348.        if it does not exist there, the first NOATMP.BAT in the DOS path
  349.        will be executed.  Same as "E" in the final menu (below).
  350.  
  351.  
  352. CUSTOMIZE HIGHLIGHT/COLORS     Specify .EXT and colors for highlight.      F8
  353.      - Allows you to change the extension NOAH highlights (default is .ZIP
  354.        files) and/or the colors in the main window.  Defaults are either
  355.        1) .ZIP and standard colors OR 2) the last .EXT and colors EXCEPT
  356.        the default TOP color for the highlight bar is always NONE. (0)
  357.  
  358.  
  359. CHANGE DRIVE/DIRECTORY         Can be aborted easily.                      F9
  360.                                See ALT+KEY addendum (end of .DOCs)
  361.  
  362. COPY MARKED                    Invokes DOS Copy across all marked files.  INS
  363.      - Prompts for a target and then copies to that target all marked
  364.        files.  Does NOT toggle marks.
  365.  
  366.  
  367. DELETE MARKED                  Internal BIOS call for deletion.           DEL
  368.      - Confirms the request, allows a view of the list of marked files, and
  369.        does NOT toggle marks.  Will NOT erase ARK.EXE even if it is
  370.        specified.
  371.  
  372.  
  373. SHELL TO DOS                   Temporary DOS Shell                         NA
  374.      - Prompts for reading of new directory/drive information upon return
  375.        to NOAH.  Not reading a new directory will invariably cause trouble
  376.        as NOAH will not have a valid filespec list.  No need to re-read if
  377.        nothing has changed.
  378.  
  379.  
  380. SET HELP LEVEL FOR WINDOW      See above window example                   F10
  381.      - Sets type of display used in the front end menu.
  382.  
  383.  
  384. RETURN TO MAIN MENU            Exit full menu screen <esc> also            /
  385.  
  386.  
  387. QUIT NOAH'S ARK                Same as pressing <esc> in main.             NA
  388.      - Confirms the request.  Alt-Q will not function from the secondary
  389.        menu.
  390.  
  391. ARK.DOC                                                              PAGE 7
  392. ------------------------------------------------------------------------------
  393.  
  394.  
  395. - THE SECONDARY .ZIP FILENAME REQUEST SCREEN:
  396. (Only appears for F1 - F3 options dealing with archives)
  397.  
  398.  
  399. ╓──────────────────────────────────────────────────────────────────────────────╖
  400. ║                     <─┘ WILL DEFAULT TO NAME_ME.ZIP                          ║
  401. ║                                                                              ║
  402. ║                                                                              ║
  403. ║                                                                              ║
  404. ║                                                                              ║
  405. ║                                                                              ║
  406. ║                                                                              ║
  407. ║                                                                              ║
  408. ║          Enter archive filename as FILENAME.EXT - or Q to abort              ║
  409. ║                                                                              ║
  410. ║                      ---»                    «---                            ║
  411. ║                                                                              ║
  412. ║                                                                              ║
  413. ║                                                                              ║
  414. ║                                                                              ║
  415. ║                                                                              ║
  416. ║                                                                              ║
  417. ║                                                                              ║
  418. ║                                                                              ║
  419. ║                                                                              ║
  420. ║                                                                              ║
  421. ║                                                                              ║
  422. ║     .EXE, .COM, & .BAT ARE ILLEGAL AS EXTENSIONS FOR ARCHIVE FILENAMES       ║
  423. ╙──────────────────────────────────────────────────────────────────────────────╜
  424. NOAH prompts for the entry of an archive filename to pass to DOS with your
  425. marked set of files.  The default is either NAME_ME.ZIP -or- the LAST filename
  426. you used during that particular session.THE SECONDARY MENU SCREEN, LEVEL 1
  427. After you have selected an ACTION from the main menu (except COPY etc.) this
  428. screen will appear.  As you scroll specific HELP screens will appear in the
  429. right window.
  430. ╔══════════════════════════════════════════════════════════════════════════════╗
  431. ║ ACTION:   ADD FILES TO AN ARCHIVE                                            ║
  432. ╟──────────────────────────────────────────────────────────────────────────────╢
  433. ║ DIR C:\                         3 / 35  MARKED &   7.61 MB FREE ON DISK      ║
  434. ╟─────────────────────────────────────┬────────────────────────────────────────╢
  435. ║                                     │                                        ║
  436. ║              CONTINUE               │            OPTION: CONTINUE            ║
  437. ║                                     │  - - - - - - - - - - - - - - - - - -   ║
  438. ║      VIEW LIST OF MARKED FILES      │  Select this option to WRITE the       ║
  439. ║                                     │  current batch of tasks assembled and  ║
  440. ║    VIEW CONTENTS OF EXTANT BATCH    │  drop to the execution options menu.   ║
  441. ║                                     │  * You must select this option to   *  ║
  442. ║        TOGGLE COMPATIBILITY         │  * create NOATMP.BAT at some point. *  ║
  443. ║                                     │  - - - - - - - - - - - - - - - - - -   ║
  444. ║       CHANGE UTILITY VERSION        │   Up/Dn to Highlight Selection         ║
  445. ║                                     │   <┘ to Select Option                  ║
  446. ║       CUSTOMIZE COMMAND LINE        │   <ESC> Returns to Main Menu           ║
  447. ║                                     │                                        ║
  448. ║        RETURN TO MAIN MENU          │   F10 Toggles WRITE mode for NOATMP    ║
  449. ║                                     │   Assemble a set using Append mode.    ║
  450. ╟─────────────────────────────────────┴────────────────────────────────────────╢
  451. ║ COMPATIBILITY: NEW                  COMMAND LINE: N/A                        ║
  452. ║ UTILITY IN USE:  PKZIP \ PKUNZIP    TARGET:  NAME_ME.ZIP                     ║
  453. ║ F1 = DOS SHELL   F5 =  CUSTOMIZE     F10 = TOGGLE WRITE MODE: OVERWRITE      ║
  454. ╚══════════════════════════════════════════════════════════════════════════════╝
  455.  
  456.  
  457. ARK.DOC                                                              PAGE 8
  458.  
  459. All the functions are the same as described above EXCEPT:
  460. - Continue means finalize your commands by coding and writing NOATMP.BAT to
  461.   disk.  You will then be prompted again for action (see below LEVEL 2).
  462. - CUSTOMIZE allows you to specify anything you wish.  (See F7 above, and
  463.   custom screen below).  If you pressed F7 from the Main menu, and NO prior
  464.   custom command line was specified, NOAH will put a flag in the "COMMAND
  465.   LINE" area reading ?SELECT CUSTOMIZE NOW? ... and you should do so by
  466.   pointing and pressing <ENTER> or pressing F5.  If you do not, and you
  467.   CONTINUE (write to NOATMP) then NOAH will put ?UNSPECIFIED? before every
  468.   filespec.  If you toggle CUSTOMIZE OFF then NOAH will default to Standard
  469.   Extract.
  470.  
  471. * TIPS: This is your chance to confirm a few KEY ITEMS.  1) Is the UTILITY
  472.   version the one YOU have in your system?  If not, change it now.  2) Is
  473.   the WRITE MODE correct?  The first time around the mode is automatically
  474.   OVERWRITE, and so whatever is in NOATMP.BAT now (if any) will be erased
  475.   in favor of the new set.  The write mode is NOT toggled by NOAH at all, and
  476.   you must control it. Append means that what you are doing NOW is ADDED ON AT
  477.   THE END of the current NOATMP.BAT.  So, develop a mental process to check
  478.   all the relevant variables on this screen so that major mistakes can be
  479.   avoided.  Don't forget that IF you -m MOVE NOATMP.BAT to and archive,
  480.   execution will HALT at the time when PKZIP puts NOATMP in the .ZIP file!
  481.  
  482.  
  483.  
  484. - The VIEW LIST OF MARKED will always show a screen like the one below
  485.  
  486. CONTENTS OF CURRENT NOATMP.BAT FILE:
  487. --------------------------------------
  488.   PKZIP  -a NAME_ME.ZIP ANSI.SYS
  489.   PKZIP  -a NAME_ME.ZIP ARK.BAK
  490.   PKZIP  -a NAME_ME.ZIP ARK.DOC
  491.   PKZIP  -a NAME_ME.ZIP ARK1.BAK
  492.  
  493. PRESS ANY KEY TO RETURN TO NOAH'S ARK
  494.  
  495. - THE SECONDARY MENU SCREEN, LEVEL 2
  496.  
  497. Your options are clear after you have written NOATMP to disk.  I suggest
  498. strongly that you routinely check the contents of NOATMP before executing.
  499. 90% of tech questions and problems start right here.  i.e. wrong utility,
  500. forgot to watch the WRITE MODE in the secondary menu level 1 etc.  Note that
  501. ALT+F1 deletes NOATMP & returns to main, this is tantamount to ABORT ALL.
  502.  
  503.  ┌───────[ CURRENT OPTIONS ]──────┐           ┌───────────[ STATUS ]───────────┐
  504.  │                                │           │                                │
  505.  │ <─┘ Return to Main             │           │          39,188 Bytes Marked   │
  506.  │                                │           │         153,682 Bytes Total    │
  507.  │ F1 - Execute NOATMP.BAT Now    │           │   25.5% of Total Bytes         │
  508.  │                                │           │                                │
  509.  │ F5 - View NOATMP.BAT Contents  │           │ 25% -          29,391 Bytes    │
  510.  │                                │           │ 50% -          19,594 Bytes    │
  511.  │ F9 - Exit NOAH Completely      │           │ 75% -           9,797 Bytes    │
  512.  │                                │           │                                │
  513.  │ ALT+F1 - ERASE NOATMP -> MAIN  │           │     1 of 18  Files Marked      │
  514.  │                                │           │                                │
  515.  └───[ <ESC>  Returns to Main ]───┘           └───────────[NOAH 2.0]───────────┘
  516.  
  517. - POWER FEATURES OF NOAH
  518. =========================
  519. * How to use the Custom Command Line *
  520. You can use ANYTHING you know to do ANYTHING with this feature.
  521.  
  522.  
  523. ARK.DOC                                                               PAGE 9
  524.  
  525. ╓────────────────────── OPTION: FULL CUSTOM COMMAND LINE ──────────────────────╖
  526. ║                                                                              ║
  527. ║    You will now define a custom command line for NOAH to pass to DOS         ║
  528. ║    with all of the marked file names.  NOAH will check neither the           ║
  529. ║    syntax nor the sensibility of what you enter so be precise.               ║
  530. ║                                                                              ║
  531. ║    The FRONT of your command line is the part that NOAH will place           ║
  532. ║    before each Filename marked, and the BACK will go behind each.            ║
  533. ║                                                                              ║
  534. ║    For example, in the command line XCOPY  ....  > NUL                       ║
  535. ║                                                                              ║
  536. ║ XCOPY is defined as the FRONT, and > NUL is the BACK where .... represents   ║
  537. ║ all of the highlighted files.                                                ║
  538. ║                                                                              ║
  539. ║ The limit is 55 characters for the FRONT, and 15 characters for the BACK     ║
  540. ║                                                                              ║
  541. ║ Type NONE at either prompt to clear & abort, CLEAR  to reset a variable.     ║
  542. ║                                                                              ║
  543. ╟──────────────────────────────────────────────────────────────────────────────╢
  544. ║   Are these selections OK? <y/n> ?                                           ║
  545. ║                                                                              ║
  546. ║   Present FRONT is: PKZIP -M  YOUR.ZIP                                       ║
  547. ║    Present BACK is: >PRN                                                     ║
  548. ║                                                                              ║
  549. ╙───────────────────────── <─┘ TO QUIT WITHOUT CHANGES ────────────────────────╜
  550.  
  551. In this example, the following would be passed to DOS:
  552.  
  553. |-------FRONT---------|                            |--BACK--|
  554.  
  555.    PKZIP -M  your.ZIP    ##all marked filespecs##     >PRN
  556.  
  557. Enough said.  The power of this feature is clear.  Custom ALT+KEY combinations
  558. can automatically configure a custom command line as well.  See ARKREG.TXT
  559. -----------------------------------------------------------------------
  560. * Common Error Conditions and what to do when you encounter one . . .
  561. -----------------------------------------------------------------------
  562. - BAD COMMAND OR FILENAME = DOS error message while executing NOATMP.BAT
  563.  
  564.   CAUSES:
  565.          A) UTILITY NAME INCORRECT - Be sure that the name you are
  566.             specifying to NOAH is the SAME as the name of the utility
  567.             as it is used within your system.
  568.          B) PKPAK/PKZIP not in DOS path - Correct win AUTOEXEC.BAT file
  569.             to be safe.  Or, copy PKZIP into a directory that is in the
  570.             path.  To see what your path is just type SET <ENTER> at the
  571.             DOS prompt.
  572.          C) YOUR CUSTOM command line is in error.  Can't help you there.
  573.             Just be sure your syntax is good, and that whatever you are
  574.             calling is either in the default subdirectory (where you are
  575.             in your system) -or- in the DOS path.
  576.  
  577. - UNABLE TO LOCATE BATCH FILE
  578.  
  579.   CAUSES:
  580.          A) You changed directories and did not write a new batch file
  581.          B) You ADDED NOATMP.BAT to an archive while NOAH was executing
  582.             NOATMP!  This is easy to do when you just highlight ALL and
  583.             proceed.  Check your list to make sure NOATMP is NOT on it.
  584.             If you do this, just return to NOAH and toggle the write
  585.             mode to OVERWRITE and try again.
  586.  
  587.  
  588.  
  589. ARK.DOC                                                            PAGE 10
  590.  
  591. - INCORRECT DOS VERSION
  592.  
  593.   CAUSES:
  594.          A) You have a copy of COMMAND.COM in your default directory that
  595.             does not match the version you booted with.  Either delete that
  596.             copy of COMMAND.COM or reboot with the same version.
  597.  
  598. - INTERNALS
  599.  
  600.   NOAH tries to tell you exactly what action failed and on what file, so
  601.   pay close attention to those!  In general, remember that NOAH needs to
  602.   have WRITE access to your disk, and will not function on a write-protected
  603.   diskette.  If your disk is full, a file is corrupt, or a file has been
  604.   deleted, NOAH will tell you about it specifically.  One fairly common
  605.   mistake is SHELLing to DOS, doing something that changes the directory, and
  606.   then returning without rereading the directory information (NOAH prompts
  607.   for that) .....  then NOAH is just plain confused about what is in the
  608.   directory it is working inside.
  609.  
  610. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  611.  
  612.  
  613.  
  614. --- .BAK TO THE FUTURE . . . .
  615.  
  616. XONFIG to control multiple boot configurations (config.sys and autoexec.bat)
  617.       easily.  menu driven, fully configured by the user.
  618. ARKKIT attendant utility for NOAH allowing several key search/catalog features
  619. NOAH upgrades the day a new archival standard appears.
  620.  
  621. EZMENU 2.00 with password protection, system lock-down, custom hotkeys and
  622.             much more.
  623.  
  624. - REGISTRATION AND SUPPORT
  625. ==========================
  626.  
  627. If you are registered, then you are already a permanent member of the support
  628. BBS.  If not, print and return ARKREG.TXT to register.  If you only want
  629. access to the board print and return BBSREG.TXT.  If you use BBSREG.TXT you
  630. *MUST* send a self-addressed stamped envelope for the return of your initial
  631. password.
  632.  
  633. 1) FREE upgrade to the next major version of NOAH'S ARK, and the attendant
  634.    utility ARKKIT (not yet released) when completed.  ARKKIT is a smart .ZIP
  635.    catalog utility with several very attractive features....... one of which
  636.    is a type of "whereis" for contents of .ZIP files.
  637. 2) BBS tech support.  (215)-367-4053
  638.    Interim upgrades will also be available to users on the BBS.
  639. 3) Consider the fact the $20 is about 4.5 cents an hour for the time it
  640.    took to develop/debug NOAH 2.1Z.  I am not trying to actually make money
  641.    writing Shareware, but that is CHEAP ... so if you like NOAH ....
  642. 4) Registration for ALL of ESAs products (even those not yet released for one
  643.    year) is $50.  i.e. EZMENU, NOAH, ARKKIT, and XONFIG.
  644.    Registration for EZMENU is now $15, and 2.00 will be $25.
  645.    ARKKIT 1.00 $15, XONFIG 1.00 $15.
  646. 5) Custom ALT+KEYS ($10 extra) within NOAH will allow you to ask for a key to
  647.    automatically configure YOUR favorite command lines and/or hotkey your
  648.    favorite utilities!  See ARKREG.TXT
  649. 6) Corporate inquiries welcomed.  Please log on to the BBS, or write to:
  650.    Sam Horton, c/o ESA, PO BOX 159, Gilbertsville, PA  19525-0159.  A custom
  651.    version for bulk corporate orders is available; NOAH may be recoded to
  652.    meet your needs.
  653.  
  654.  
  655.  
  656. ARK.DOC                                                             PAGE 11
  657.  
  658. UPDATE v2.1Z 1.89 > ALT+KEYS NOW AVAILABLE!
  659. ALT+R Calls RN, the PC Mag utility for changing directories and/or calling
  660.       CO.COM ........  (c) Ziff Davis 1988
  661. ALT+L Calls Buerg's LIST across the marked filespecs.  (c) V. Buerg 1986
  662.  
  663. The usefulness of these features is clear: what NOAH lacks in these areas
  664. is bolstered by these utilities.  They are not required for NOAH to operate.
  665.  
  666. CUSTOM ALT+KEYs that can configure a custom command line for you or call to
  667. DOS for anything you can name are available with registration.  See ARKREG
  668.  
  669. - TECHNICAL REQUIREMENTS AND LIMITATIONS OF NOAH 2.1Z
  670. ------------------------------------------------------
  671. 1) PKPAK/PKUNPAK -or- PKZIP/PKUNZIP in the DOS path.
  672. 2) 150K available runtime RAM (Min)  200K for heavy use.
  673. 3) Available disk space of 5K to write NOATMP.BAT and NOADIR.TMP
  674. 4) Color Monitor and HD recommended.
  675. 5) NOAH 2.01 is identical excepting the fact that it comes bundled with EZMENU
  676.    and requires BRUN40.EXE be present in the DOS path.
  677. 6) NOAH does not provide extensive error trapping in this release, so please
  678.    read (in this file) about what error conditions can occur and what to do
  679.    if you encounter one.
  680. 7) DOS 3.xx  -  Soon this requirement will be relaxed.
  681.  
  682. - TECHNICAL POINTS ABOUT NOAH'S OPERATION
  683. ==========================================
  684. - Pressing -I- while in the main menu redraws the screen.
  685. - NOAH will mark the file your pointer is on IF there are no other files
  686.   marked and you select an action.
  687. - NOAH will NOT delete ARK.EXE even if you tell it to do so.
  688. - NOAH leaves no "litter" .TMP files etc., just NOATMP.BAT
  689. - Starting in an empty subdirectory results in passing to the "change drive/
  690.   subdirectory routine.  Entering Q at that time will EXIT NOAH altogether.
  691. - NOAH contains internal hack alert self-checking routines that detect
  692.   tampering with the (c), registration status, and location of certain
  693.   routines.  So, if you inspect the code do not be surprised when you find
  694.   those internal messages.  If you get a copy that sets off, please DO NOT
  695.   use it!  Send it to me and you will receive a FREE registered copy for
  696.   the trouble.  Don't forget to tell me EXACTLY where you got it.
  697. - NOAH uses the following filenames in the course of running on your system:
  698.   NOADIR.TMP - Temporary directory info file.  Deleted immediately after use.
  699.   RKONE.TXX  - Temporary ASCII file for dumping -vc output to.  Deleted
  700.                immediately after use.
  701.   CTMP.BAT   - To copy files.  Deleted upon reentry to NOAH.
  702.   NOATMP.BAT - To store your commands.  Never deleted.  NOAH will whack this
  703.                one with a delete command though, so be careful.
  704.   ALLZIP.TXT - Temp ASCII file for dump of all .ZIP contents
  705. _______________________________________________________________
  706.  
  707. ********************** SPECIAL THANKS *************************
  708. _______________________________________________________________
  709.  
  710. * To Peter Rucci, Sysop of the Del-Ches BBS for timely advice on software,
  711. shareware/greedware/crippleware policy, and ZENITH crash-testing.  (NOAH
  712. will operate on Zeniths now.)   A thanks to the DELCHUG and its President
  713. Howard Palmer for a great deal of technical help and useful chatter.
  714. * To Ed Watson for technical assistance in BBS matters and QB coding tricks.
  715.  
  716. * To Phil Katz, Steve Kolterman, James Wallen and others who provided advice
  717. and/or testing support during the dark coding days of release 2.00.
  718.  
  719.  
  720.  
  721. ARK.DOC                                                              PAGE 12
  722.  
  723. * To the BETAs who helped so much with wry comments on what would fly and
  724. what would not.  To my wife who put up with all the time it took.
  725.  
  726. TO ALL THE REGISTERED USERS WHO MADE IT WORTH THE WORK, WHO SUGGESTED
  727. BBS (NOT VOICE) TECH SUPPORT AND KEY FEATURES INCLUDED WITHIN NOAH 2.1Z!!!
  728.  
  729.   -------------  Thanks one and all!  ----------------
  730. ____________________________________________________________________________
  731.  
  732. Disclaimer:  ESA disclaims all liability which may arise as a result of
  733. the use of, or inability to use this software product.  ESA makes only a
  734. warranty of fitness for the particular purpose for which the program was
  735. designed, and cannot be responsible for the quality of any individual copy
  736. UNLESS it is downloaded directly from the ESA tech support BBS, or obtained
  737. as a result of registration.  ESA's liability shall be limited only to the
  738. replacement of the software in any event.
  739.  
  740. PKPAK/PKZIP (c) 1986-1988 PKWARE & Phil Katz
  741. NOAH'S ARKIVE MANAGEMENT SYSTEM (c) 1988 ESA & Sam Horton
  742. LIST (c) 1986 Vernon D. Buerg
  743. RN & CO (c) 1988 Ziff Davis Publishing Co.
  744.  
  745. eof
  746.